home *** CD-ROM | disk | FTP | other *** search
/ Aminet 19 / Aminet 19 (1997)(GTI - Schatztruhe)[!][Jun 1997].iso / Aminet / util / cli / ksc_GrepMem.readme < prev    next >
Text File  |  1997-05-03  |  4KB  |  86 lines
  1. Short:    Grep through memory for strings! *KYZSMLCLXN*
  2. Author:   Kyzer/CSG
  3. Uploader: Kyzer/CSG <kyzer@4u.net>
  4. Type:     util/cli
  5.  
  6. Grepmem is named after a unix program that hunts through files for a string
  7. or a pattern. But let me tell you now, GREPMEM DOESN'T DO PATTERNS!
  8.  
  9. Instead, it will search through memory for an exact match of the string
  10. you supply to it. You can also define which part of memory to search - if
  11. you don't, it will assume to search all chip memory.
  12.  
  13. You do not have to, but it is a good idea to put "quotes round the string"
  14. that you want to search for. Why? Well, getting your input into memory and
  15. printing it out a few times will leave some copies around in memory. If
  16. you put quotes around your string, it will search for the string WITHOUT
  17. THE QUOTES, and if it finds a copy that *is* in quotes, it will NOT match
  18. it.
  19.  
  20. If you are using addresses, you must supply them in hexadecimal. It can be
  21. any format, either the naked hex number on it's own, or starting with "$"
  22. or "0x", but BEWARE! I parse the address by assuming all characters are
  23. part of the address, and "$" and "x" are equal to the digit "0", therefore:
  24.  
  25. 0xDEADBEEF   = 00DEADBEEF = DEADBEEF
  26. DEAD0xBEEF   = DEAD00BEEF and is NOT = DEADBEEF
  27. $11 = 11
  28. 11$ = 110
  29. 1$1 = 101
  30.  
  31. So be careful about that.
  32.  
  33. There is a final option, PADZEROS, which means (if you switch it on) that:
  34.  
  35. Grepping memory for "c" from $200 to $F00, please wait.
  36. Hits:       $59B        $59D        $E52        $ED9        
  37. Grep finished, 4 occurences.
  38.  
  39. will become:
  40.  
  41. Grepping memory for "c" from $500 to $F00, please wait.
  42. Hits:       $0000059B   $0000059D   $00000E52   $00000ED9   
  43. Grep finished, 4 occurences.
  44.  
  45. EXAMPLES:
  46. look through chipmem for a powerpacker file
  47. 1> grepmem "PP20"
  48. look through the amiga rom for references to Amiga
  49. 1> grepmem "Amiga" f80000 1000000
  50.  
  51. If you run the program without supplying any arguements, it will show a
  52. brief little help message. The program is pure and can be made resident.
  53. There is a little hack for the PADZERO option that is not pure, but it will
  54. not cause a problem of any kind except if you use the PADZERO option while
  55. another resident copy of grepmem is running, you will get this interesting
  56. effect:
  57.  
  58. Grepping memory for "c" from $500 to $5F00, please wait.
  59. Hits:       $59B        $59D        $E52        $ED9        $F39
  60. $1035       $2043       $0000059D   $00000E52   $00000ED9
  61.  
  62. ....
  63.  
  64. Requires 2.04 or better.
  65.  
  66. ****************************************************************************
  67. *          THIS PROGRAM IS PART OF THE "KYZER'S SMALLS" COLLECTION         *
  68. *                                                                          *
  69. *      The KyzSmlClxn is a set of very small, but useful CLI commands.     *
  70. *                                                                          *
  71. *   Source in assembler is included. Install by copying the command to C:  *
  72. *                                                                          *
  73. *     Kyzer/CSG, 49 Fairview Road, AB22 8ZG, Scotland ---- kyzer@4u.net    *
  74. ****************************************************************************
  75.  
  76.  
  77. ============================= Archive contents =============================
  78.  
  79. Original  Packed Ratio    Date     Time    Name
  80. -------- ------- ----- --------- --------  -------------
  81.     1400     935 33.2% 08-Apr-97 02:56:28  GrepMem
  82.     5217    2245 56.9% 08-Apr-97 02:56:20  GrepMem.asm
  83.     3110    1362 56.2% 08-Apr-97 05:26:16  GrepMem.readme
  84. -------- ------- ----- --------- --------
  85.     9727    4542 53.3% 10-Apr-97 19:05:44   3 files
  86.